In short:
==========
Just get started:
Unzip the file, then run "install.exe".

Everything then will (hopefully) become clear.

If not, here are a few details:

VRWeather.exe is a GUI version of Frank Wochat's WPWeather.cmd,
with a few minor enhancements:

- Additional weather data:
  > Air pressure
  > Sunshine duration
  > Wind force of gusts

- Show weather data for "Today" at a specific hour

- Show weather data for any 3 days in the future

- Kiosk-mode: show weather data continously at a given
  interval of time

- Log file analysis showing the forecast accuracy of "Yesterday" for "Today".

VRWeather is named as such because it was created with VX-Rexx.

=============
INSTALLATION:
=============

(1) Unzip the archive into a newly created directory.
    When unzipping, be aware that subdirectories will be created automatically.
    For example, use this command:
    unzip vrweather.zip

(2) 	First, create a config-file: Weather.cnf:
	Ŀ
	PLACE=my place		; user-defined, optional, description   
				; or <auto> = name of DWD-station       
	CITY=anyvillage	; should exist in the City-List	        
				; else remove this line 		
	LATITUDE=54.0833	; if no CITY -> then required!	        
	LONGITUDE=12.1333	; if no CITY -> then required!	        
	                                                               
	Language=EN		; or DE or ES                           
	                                                               
	ICONSET=1		; or 2 or 3 or 4			
	LOG=1			; or 0 (no log files written)		
	                                                               
	OPTAHEAD=1		; 0=no 1=for today 3=for all 3 days	
	CLOCK=1		; or 0 (no display of clock)	        
	                                                               
	

    You may use "ProtoE.cnf" as a prototype for your "Weather.cnf".

    NOTE: This step is done automatically by install.exe.

(3) Start VRWeather.exe:
    In case you have not created a file "Weather.cnf" then a dialog box will
    appear: "No config file found."
    Click OK. A dialog box will then open for creating
    the config file Weather.cnf.
    The instructions should be self-explanatory.

    After entering the CITY or, AT LEAST the coordinates, click SAVE.

    The program is now ready for use. The current weather data for today, 
    tomorrow, and the day after tomorrow will be displayed.

    Optionally, you may request weather data for any date in the future.

    Install more city-lists (*.CLS):
    -----------------------
    From the website www.simpleminds.com you can download a city-list for
    every country in the world, in csv-format. In order to make these files
    accessable to VRWeather you need to process it with the Rexx-script
    BuildCLS.cmd (which is part of this package):
    From the commandline: BuildCLS <country>.csv
    which renders a file named <country>.CLS.

    Note that not all of the cities in these lists have valid coordinates,
    which means these locations are not served by the german DWD-Agency.
    This holds mainly for cities not within the european community.


=============
USAGE:
=============

    Clicking the "refresh" button retrieves the weather data again.

    * Kiosk-mode:
    To automate the updates, you can select an interval in the adjacent
    selection box, e.g., "2" for every 2 hours. The least of possible
    intervals being 0.1, i.e. 6 minutes. In that case the weather data
    a renewd automatically every 6 minutes so you can observe changes
    in your local climate by one simple glance.

    * Select a different location:
    Type any city name into the input field in the upper left corner and
    click the double arrow (to the right of it).

    If the text "not in list" is then displayed, the coordinates
    (latitude and longitude) must be determined manually and entered
    into the Weather.cnf file. maps.google.com will help you in this.

    * To permanently add another location to the city list:
    Position the mouse over the drop-down box (top left, "select city"), then open
    the context menu (right-click). Click on "Insert <new city> in city-list".

    ==> For further functions, access the context menu (right-click on
    an empty area of the program window).


===============
and more:
===============

Thanks to Frank Wochatz 
    for providing us his "weather engine" in well-structured Rexx code
    and his permission to use his code in my GUI-version!


Contact:
	Lutz.Wagner@hamburg-email.de


